跳到主要内容

多帧生视频

更新时间：2026-02-09 11:32:15
根据多关键帧图片生成视频，每个任务最多9个关键帧，最少2个关键帧。仅支持异步模式。调用该接口前，需要先调用“上传文件”接口获取图片的路径。
POST
https://cloud.baicaiinfer.com/v1/videos/generations
Authorizations
Authorizations：StringHeaderRequired

用户需使用已获取的API Key进行身份验证，以访问服务。

Body
application/json
selected_model：StringRequired

指定生成式任务中要使用的模型名称，支持选择“viduq2-turbo-MF2V、viduq2-pro-MF2V”。更多模型，可参考支持的模型。

task_type：StringRequired

指定生成式模型需执行的任务类型，用于明确模型的工作目标，指定multi_frame_img2video。

input：object | nullRequired

输入参数集合。

input.img_url：StringRequired

首帧图。

input.prompt：StringRequired

首帧图延长的提示词，用来控制延长的视频内容。

input.negative_prompt：String

用于指定生成视频时需避免的元素（如低质量、失真等）的反向提示词，以优化生成结果的质量。

input.resolution：StringRequired

分辨率（540P、720P、1080P）。

input.aspect_ratio：StringRequired

宽高比（1:1、3:4、4:3、9:16、16:9）。传入的resolution 、aspect_ratio值会和既定的值相匹配，如果不符合则直接报错。注意传width， height则不会生效。

input.number_of_videos：integer

指定生成视频的数量，用于控制一次请求返回的视频总数，不传，则默认生成一个视频。

input.duration：integerRequired

多帧时长。不同关键帧之间的视频时长，默认5s，可选项为2～7s。

input.true_cfg_scale：numberRequired

指导尺度（通常 1.0 ~ 20.0，常用范围5.0 ~ 15.0）：3.0 - 7.0表示获得更多意外惊喜和创意组合；7.0 - 10.0表示在遵循提示词和图像质量间取得平衡；10.0 - 15.0表示严格遵循文本描述，适合产品设计；1.0 - 5.0表示获得更抽象、interpretive的结果。

input.num_inference_steps：integerRequired

推理步数，影响单帧画面的生成质量和细节。

input.fps：integerRequired

每秒播放的帧数，影响视频播放的流畅度。

input.seed：integerRequired

生成式模型中控制结果随机性的种子，固定它可复现相同结果，改变则生成不同内容，示例：0。

input.mutil_reference：Array<Object>Required

关键帧配置，每个任务最多9个关键帧，最少2个关键帧。

input.mutil_reference.prompt：StringRequired

上一张图像继续延长的提示词，用来控制延长的视频内容。

input.mutil_reference.duration：StringRequired

多帧时长。不同关键帧之间的视频时长，默认5s，可选项为2～7s。

input.mutil_reference.urls：StringRequired

对应的关键帧图片url。

need_expand_prompt：Boolean

优化提示词。

async：BooleanRequired

异步函数。

Response
状态码：
200
application/json
code：String Required

表示请求处理状态的状态码。

0是成功标识，表示接口正常返回预期结果。
message：StringRequired

返回请求的处理结果，通常配合状态码使用，直观告知用户当前请求的具体情况。

data：objectRequired

任务的核心结果数据。

data.taskId：StringRequired

任务的唯一标识ID。

data.status：StringRequired

任务的执行状态，包括：PENDING、PROCESSING、COMPLETED、FAILED、CANCELED、UNKNOWN。

data.progress：StringRequired

任务完成进度，包括：排队中、生成中、已完成、已失败、用户主动取消、未知，对于taskId不存在时返回此状态，与status参数值一一对应。

result：objectRequired

任务返回的结果。

result.urls：String

是生成视频的网络访问链接，通过该URL可直接下载或在线查看视频文件，适合需要快速预览或通过链接分享的场景。

ts：StringRequired

响应的时间戳。

curl --location --request POST 'https://cloud.baicaiinfer.com/v1/videos/generations' \
--header 'Authorization: Bearer sk-RVkVZVd57hLruMHEu9t*****' \
--header 'Content-Type: application/json' \
--data-raw '{
    "selected_model": "viduq2-turbo-MF2V",
    "task_type": "multi_frame_img2video",
    "input": {
        "img_url": "https://s1.llamafactory.online/baicai-infer/users/04527f5b186a4b3587863399402cf0d2/8rWaJl-Baicai_Creation_20260120150937498972.png",
        "prompt": "human and dog paly on the grass",
        "resolution": "720P",
        "aspect_ratio": "1:1",
        "number_of_videos": 1,
        "duration": 5,
        "fps": 16,
        "num_inference_steps": 30,
        "true_cfg_scale": 7.5,
        "seed": 0,
        "mutil_reference":[
            {
                "prompt": "the boy and dog play",
                "duration": 5,
                "urls" : ["https://s1.llamafactory.online/baicai-infer/users/04527f5b186a4b3587863399402cf0d2/8rWaJl-Baicai_Creation_20260120150937498990.png"]
            },
            {
                "prompt": "boy and dog go home,no one left hear",
                "duration": 5,
                "urls" : ["https://s1.llamafactory.online/baicai-infer/users/04527f5b186a4b3587863399402cf0d2/8rWaJl-Baicai_Creation_20260120150937408090.png"]
            }
        ]
    "need_expand_prompt": false,
    "async": true
    }
 
}
{
    "code": 0,
    "message": "查询成功",
    "data": [
        {
            "taskId": "857b5c4d27504a4abccc38f925e*****",
            "status": "COMPLETED",
            "progress": "已完成",
            "result": {
                "urls": [
                    "https://s1.llamafactory.online/baicai-infer/results/857b5c4d27504a4abccc38f925e*****/output_857b5c4d27504a4abccc38f925eae27b_0.mp4"
                ]
            }
        }
    ],
    "ts": "2026-02-06T16:14:53.189868134+08:00[Asia/Shanghai]"
}